home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1993 December / PSL Monthly Shareware CD-ROM (December 1993).iso / prgmming / dos / gen_vid / sam2.exe / SAM2.DOC < prev   
Text File  |  1993-07-06  |  7KB  |  139 lines
  1.                            Source Application Manager
  2.                            =-=-=-=-=-=-=-=-=-=-=-=-=-
  3.  
  4. First of all I have to print here the usual DISCLAMER trick, just skip it
  5. if, like me, you know it by heart...
  6.  
  7.                             DISCLAIMER OF WARRANTY
  8.  
  9.                THIS SOFTWARE AND MANUAL ARE SOLD "AS IS" AND WITHOUT
  10.                WARRANTIES AS TO PERFORMANCE OF MERCHANTABILITY OR ANY
  11.                OTHER WARRANTIES WHETHER EXPRESSED OR IMPLIED.  BECAUSE
  12.                OF THE VARIOUS HARDWARE AND SOFTWARE ENVIRONMENTS INTO
  13.                WHICH THIS PROGRAM MAY BE PUT, NO WARRANTY OF FITNESS FOR
  14.                A PARTICULAR PURPOSE IS OFFERED.  GOOD DATA PROCESSING
  15.                PROCEDURE DICTATES THAT ANY PROGRAM BE THOROUGHLY TESTED
  16.                WITH NON-CRITICAL DATA BEFORE RELYING ON IT.  THE USER
  17.                MUST ASSUME THE ENTIRE RISK OF USING THE PROGRAM.  ANY
  18.                LIABILITY OF THE SELLER WILL BE LIMITED EXCLUSIVELY TO
  19.                PRODUCT REPLACEMENT OR REFUND OF PURCHASE PRICE.
  20.  
  21. HISTORY:
  22. ────────
  23.  
  24. Developping several applications not only for PC computers, I was fed of
  25. having to always remember the different commands to access to different
  26. editor functions depending on the language used. I also had to remember
  27. the command line syntax to compile and link with and without debug records
  28. Etc ...
  29. I decided to develop a common "desktop like" system that allows me to
  30. always use the same commands for whatever development on whatever computer...
  31. Here is how SAM was born a couple of years ago (April 1990). The memory
  32. requirements of some compilers or utilities (such as MAKE) made me create
  33. a new version that swaps itself out of memory before invoking an external
  34. procedure.
  35. That's SAM2.COM created end 1992 and tested since by our programming
  36. structure using several types of computers (8088,286,386 and even 486 !)
  37. As an example, you will find enclosed a couple of batch files that I use
  38. every day with my SAM2.COM program. In fact SAM2 was developed in assembly
  39. using SAM itself !!!
  40. You will also find on the disk a set of batch files to manage you fax
  41. including the transfer via a fax-card ...
  42.  
  43.  
  44. DESCRIPTION:
  45. ────────────
  46.  
  47. SAM2 is a small shareware utility that provides an easy way to select and
  48. process any module part of an application development. From the SAM2 program
  49. you can EDIT, COMPILE, LINK with any Editor of your choice, any compiler and
  50. linker. The TRANSFER option allows you to send the resulting porgram on an
  51. eventual target machine via COM1 or COM2 at any speed between 300 up to 38400
  52. baud (depending on the paramters set in OPTION menu). OPTION allows you to
  53. setup communication parameters if needed and determine if the compiler and
  54. linker should create a simulation or target version of the application
  55. (ie: you can add DEBUG statements in simulation mode). EXTERN allows you
  56. to add some new features that are specific to the actual development
  57. (ie: edit linker config file, run simulator, ....)
  58.  
  59. Every function can be parametrized externally to fit nearly any case.
  60.  
  61. The main screen displays a picklist style box showing every files that fit
  62. in the <filespec> option given on the command line.
  63.  
  64. You can go thru this list using the UP,DOWN,PAGEUP,PAGEDOWN,HOME and END keys
  65. or when you "click" the mouse on it. You can even access to a file using its
  66. initial letter. If you press it twice you go to the next entry starting with
  67. this letter, and so on ... until you wrap around and start again.
  68.  
  69. The main menu displays EDIT COMPILE LINK TRANSFER OPTION EXTERN HELP QUIT
  70.  
  71. All these choices can be accessed by the ALT + first letter combination or
  72. using F1 to F7 key in sequence or using a mouse. (Note that QUIT can also be
  73. accessed thru the ESC key).
  74.  
  75. Any of these choices (except OPTION & HELP) will call an external batch file
  76. which name is EXECF?.BAT where ? stands for the corresponding function key.
  77.  
  78. ie: EDIT will call EXECF1.BAT, COMPILE calls EXECF2.BAT, etc ...
  79.  
  80. NOTE : If the corresponding EXECF?.BAT file does not exist, the menu item
  81. ─────  will be disabled. Even OPTION must have a dummy EXECF5.BAT file
  82.  
  83. The batch files are called with several parameters:
  84.  
  85. %1 : Whole filename chosen in the list             (ie: MYFILE.SRC)
  86. %2 : Radical name                                  (ie: MYFILE    )
  87. %3 : Extension                                     (ie: SRC       )
  88. %4 : Target/Simulation Flag from the OPTION menu   (ie: T or S)
  89. %5 : Communication port from the OPTION menu       (ie: 1 or 2)
  90. %6 : Communication speed from the OPTION menu      (ie: 9600  )
  91.  
  92. for the EXECF6.BAT only (extern function)
  93. %7 : Name of the external function invoked (converted to Upper case !)
  94.  
  95. Syntax : SAM2 <filespec> <exec path> <System name> [<extern function> ...]
  96.  
  97. <filespec> : File specification for the source list (ie: *.SRC)
  98.              The corresponding files will be display as a list in which you
  99.              can select an item and process it.
  100.  
  101. <exec path>: Is the path where all the exec batch files can be found.
  102.  
  103. <system name> : Is a 15 max. character name displayed on the lower right
  104.                 corner of the screen to describe the system you are working
  105.                 on.
  106.  
  107. <extern function> : optional new function that you want to add in this
  108.                     development system (ie: CONFIG)
  109.                     Note: If this function is composed of several words, just
  110.                     ───── type them between quotes (ie:"Config Link")
  111.  
  112. Example: SAM2 *.SRC . "My SYSTEM" Extern1
  113.  
  114. Will call SAM2.COM, displaying every SRC files in the picklist box, calling
  115. every EXECF?.BAT file in the current directory, showing My SYSTEM as the
  116. system name on the lower right corner of the screen, and adding Extern1 as
  117. an Item of the EXTERN menu.
  118.  
  119. 1.During spawning of command.com for EXECF?.BAT, the SAM2 programs overlays
  120.  itself either on disk or in EMS memory, if any, to leave as much as possible
  121.  free space for the EXECF?.BAT execution. The remaining part of SAM2 (less
  122.  than 1 Ko) will take back control and swap in again.
  123.  
  124. 2.The filespec can be multiple filespecs separated by semi-colons (;).
  125. I.e.: SAM *.C;*.H \BATCH TEST
  126. will display all the .C and .H files contained in the current directory.
  127.  
  128. REGISTRATION : Send me a postcard showing the town you live in ! That's all.
  129.  
  130. If you want to give me any input, just post me a message...
  131.  
  132. COMPUSERVE ID = [76557,1115] or
  133.  
  134. Olivier MOGENOT
  135. Etang des Grenouilles
  136. 38790 CHARANTONNAY
  137. FRANCE
  138.  
  139.